home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / pcp_eoe / ch2.z / ch2
Text File  |  2001-04-17  |  17KB  |  475 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_X
  11.        _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e.  The
  12.        information listed here is product- and release-specific;
  13.        use it with the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e to
  14.        install this product.
  15.  
  16.        2.1  _P_e_r_f_o_r_m_a_n_c_e__C_o_-_P_i_l_o_t__S_u_b_s_y_s_t_e_m_s
  17.  
  18.        The _p_c_p__e_o_e product includes these subsystems:
  19.  
  20.        _p_c_p__e_o_e._b_o_o_k_s._O_V_i_e_w_H_e_l_p
  21.                    SGIHelp book for the oooovvvviiiieeeewwww(1) application from
  22.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  23.  
  24.        _p_c_p__e_o_e._b_o_o_k_s._P_m_R_u_n_H_e_l_p
  25.                    SGIHelp book for the ppppmmmmrrrruuuunnnn(1) application from
  26.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  27.  
  28.        _p_c_p__e_o_e._b_o_o_k_s._P_m_T_i_m_e_H_e_l_p
  29.                    SGIHelp book for the ppppmmmmttttiiiimmmmeeee(1) application from
  30.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  31.  
  32.        _p_c_p__e_o_e._m_a_n._p_a_g_e_s
  33.                    Manual pages for the tools and libraries.
  34.  
  35.        _p_c_p__e_o_e._m_a_n._r_e_l_n_o_t_e_s
  36.                    These release notes.
  37.  
  38.        _p_c_p__e_o_e._s_w._e_o_e
  39.                    Executable programs, libraries, scripts and
  40.                    configuration files that are required for every
  41.                    PCP deployment.
  42.  
  43.                    You need to install this subsystem if you wish
  44.                    to use any tools or products that use the PCP
  45.                    2.1 infrastructure.
  46.  
  47.        _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r
  48.                    Some bundled performance monitoring tools.
  49.  
  50.        _p_c_p__e_o_e._s_w_6_4._e_o_e
  51.                    64-bit libraries that may be installed on 32-bit
  52.                    IRIX platforms for PCP developers.  Note that on
  53.                    64-bit IRIX platforms all required libraries
  54.                    (32-bit and 64-bit) are installed from
  55.                    _p_c_p__e_o_e._s_w._e_o_e and so it is expected that
  56.                    _p_c_p__e_o_e._s_w_6_4._e_o_e will nnnnooootttt be installed on most
  57.                    systems.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        2.2  _S_u_b_s_y_s_t_e_m__R_e_-_s_t_r_u_c_t_u_r_i_n_g__f_r_o_m__P_C_P__1_._x
  75.  
  76.        Some re-arrangement of the subsystem structure for the PCP
  77.        product occurred between versions 1.x and version 2.0, most
  78.        notably the splitting of _p_c_p into _p_c_p__e_o_e and _p_c_p.  The
  79.        table below describes the relationship between the changed
  80.        subsystems in the two versions.
  81.  
  82.               ______________________________________________
  83.                                         Corresponding
  84.                PCP 1.x Subsystem   Subsystem(s) for PCP 2.x
  85.               ____________________________________________________________________________________________
  86.                pcp.sw.collector    pcp_eoe.sw.eoe
  87.                                    pcp.sw.base
  88.               ______________________________________________
  89.                pcp.sw.eoe          pcp.sw.base
  90.                                    pcp_eoe.sw.eoe
  91.               ______________________________________________
  92.                pcp.sw.monitor      pcp_eoe.sw.monitor
  93.                                    pcp.sw.monitor
  94.               ______________________________________________
  95.                pcp.man.pages       pcp_eoe.man.pages
  96.                                    pcp.man.pages
  97.               ______________________________________________
  98.               |||||||||||||
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                  |||||||||||||
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                                             |||||||||||||
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.        2.3  _P_e_r_f_o_r_m_a_n_c_e__C_o_-_P_i_l_o_t__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  134.  
  135.        This section lists the _p_c_p__e_o_e subsystems (and their sizes).
  136.  
  137.        If you are installing this product for the first time, the
  138.        subsystems marked ``default'' are the ones that are
  139.        installed if you use the ``go'' menu item.  To install a
  140.        different set of subsystems, use the ``install,''
  141.        ``remove,'' ``keep,'' and ``step'' commands in iiiinnnnsssstttt to
  142.        customize the list of subsystems to be installed, then
  143.        select the ``go'' menu item.
  144.  
  145.        Note:  The listed subsystem sizes are approximate. Refer to
  146.               the _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g
  147.               _G_u_i_d_e for information on finding exact sizes.
  148.  
  149.        24.if 720<336 .nr 46 336
  150.        Subsystem Name                   Subsystem Size
  151.                                         (Kbytes)
  152.        _p_c_p__e_o_e._b_o_o_k_s._O_V_i_e_w_H_e_l_p                400
  153.        _p_c_p__e_o_e._b_o_o_k_s._P_m_R_u_n_H_e_l_p                300
  154.        _p_c_p__e_o_e._b_o_o_k_s._P_m_T_i_m_e_H_e_l_p               350
  155.        _p_c_p__e_o_e._m_a_n._p_a_g_e_s                      300
  156.        _p_c_p__e_o_e._m_a_n._r_e_l_n_o_t_e_s (default)          50
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                   - 3 -
  171.  
  172.  
  173.  
  174.        _p_c_p__e_o_e._s_w._e_o_e (default)              4100
  175.        _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r                     800
  176.        _p_c_p__e_o_e._s_w_6_4._e_o_e                       500
  177.  
  178.        _p_c_p__e_o_e._s_w._x_v_m                         110
  179.  
  180.  
  181.  
  182.  
  183.        _2._4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  184.  
  185.        All of the subsystems for _p_c_p__e_o_e can be installed using
  186.        IRIX.  You do not need to use the miniroot.  Refer to the
  187.        _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e for
  188.        complete installation instructions.
  189.  
  190.        2.5  _P_r_e_r_e_q_u_i_s_i_t_e_s
  191.  
  192.        If Performance Co-Pilot is to be installed in a ccccoooolllllllleeeeccccttttoooorrrr
  193.        ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn then the _l_i_b_i_r_i_x_p_m_d_a._s_o library is required to
  194.        export performance metrics from IRIX.
  195.  
  196.        The following table describes where to locate the
  197.        appropriate version of _l_i_b_i_r_i_x_p_m_d_a._s_o.
  198.  
  199.             _________________________________________________
  200.              IRIX           Source of _l_i_b_i_r_i_x_p_m_d_a._s_o
  201.             __________________________________________________________________________________________________
  202.                     /_u_s_r/_p_c_p/_l_i_b/_l_i_b_i_r_i_x_p_m_d_a._s_o is shipped
  203.                     as part of the IRIX _p_c_p__e_o_e._s_w._e_o_e
  204.                     subsystem.
  205.              6.5
  206.  
  207.  
  208.             _________________________________________________
  209.                     The files
  210.                     /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_*./_l_i_b_i_r_i_x_p_m_d_a._s_o
  211.                     should be installed from the IRIX patch
  212.                     ppppaaaattttcccchhhhSSSSGGGG0000000000003333333333334444....eeeeooooeeee____sssswwww....ppppeeeerrrrffff that is
  213.                     included with the Performance Co-Pilot
  214.                     distribution.  This patch updates the
  215.                     IRIX 6.2 _e_o_e._s_w._p_e_r_f subsystem.
  216.              6.2
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.             _________________________________________________
  224.             |||||||||||||
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                   |||||||||||||
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                                                              |||||||||||||
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.        For hosts in a PCP mmmmoooonnnniiiittttoooorrrr----oooonnnnllllyyyy ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn which are
  260.        upgraded to PCP 2.x and used to monitor remote PCP collector
  261.        hosts running PCP 1.x, the IRIX metrics must appear in the
  262.        local Performance Metrics Name Space (PMNS) on the PCP
  263.        monitor host.
  264.  
  265.        For IRIX 6.5 systems, the IRIX metrics are included in the
  266.        PMNS from the _p_c_p__e_o_e._s_w._e_o_e subsystem, so there is no
  267.        issue.
  268.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.                                   - 4 -
  281.  
  282.  
  283.  
  284.        For systems running earlier IRIX releases, the IRIX metrics
  285.        are included with the _l_i_b_i_r_i_x_p_m_d_a patches, as described in
  286.        the table above.
  287.  
  288.        The work around then, even if ppppmmmmccccdddd(1) is not running, is to
  289.        install the appropriate _l_i_b_i_r_i_x_p_m_d_a patch on the PCP monitor
  290.        system, and then run the following commands as rrrrooooooootttt:
  291.  
  292.            # cd /var/pcp/pmns
  293.            # ./Rebuild -du
  294.  
  295.        There is no issue if the remote PCP collector hosts are
  296.        running PCP 2.x as the distributed name space services will
  297.        be used in preference to any local PMNS.
  298.  
  299.        The _p_c_p__e_o_e._b_o_o_k_s.* subsystems require the _i_n_s_i_g_h_t__b_a_s_e._s_w
  300.        images to be installed.
  301.  
  302.        The _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r utilities require dynamic shared
  303.        libraries from the subsystems: _V_i_e_w_K_i_t__e_o_e._s_w._b_a_s_e and
  304.        _i_n_v_e_n_t_o_r__e_o_e._s_w._i_n_v_e_n_t_o_r (version 2.1 or later).
  305.  
  306.        If the Performance Metrics Collector Daemon (PMCD) is
  307.        already running on the system to which the new installation
  308.        is going to be applied, then you must terminate ppppmmmmccccdddd before
  309.        starting the installation.  Similarly, any instance of the
  310.        ppppmmmmllllooooggggggggeeeerrrr utility should be terminated.  For example, use the
  311.        following commands as rrrrooooooootttt:
  312.  
  313.            # /etc/init.d/pcp stop
  314.            # killall -INT pmlogger
  315.  
  316.        This is necessary because the subsystems to be installed
  317.        include new versions of shared libraries (DSOs) that may be
  318.        used by these PCP utilities.
  319.  
  320.        2.6  _C_o_n_c_u_r_r_e_n_t__I_R_I_X__U_p_g_r_a_d_e_s
  321.  
  322.        If you have PCP 1.x installed and are concurrently upgrading
  323.        IRIX and PCP, or have PCP 2.x installed and are upgrading
  324.        IRIX, then there are some complex product interdependencies
  325.        that are best addressed by following the recommended
  326.        procedures below.
  327.  
  328.  
  329.        IIIIRRRRIIIIXXXX 5555....3333,,,, 6666....2222,,,, 6666....3333 oooorrrr 6666....4444 aaaannnndddd PPPPCCCCPPPP 1111....xxxx ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP
  330.        2222....1111
  331.        IIIIRRRRIIIIXXXX 5555....3333,,,, 6666....2222,,,, 6666....3333 oooorrrr 6666....4444 aaaannnndddd PPPPCCCCPPPP 2222....xxxx ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP
  332.        2222....1111
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.                                   - 5 -
  347.  
  348.  
  349.  
  350.        NNNNooootttteeee Due to migration of features from PCP to IRIX, PCP 2.1
  351.        requires IRIX 6.5 to be the 6.5.5 release or later.  For
  352.        versions of IRIX 6.5 prior to 6.5.5, the earlier PCP 2.0
  353.        distribution should be used.
  354.  
  355.        In all cases, use the PCP 2.1 CD concurrent with the IRIX
  356.        CDs to install or upgrade _p_c_p__e_o_e and upgrade _p_c_p at the
  357.        same time that all IRIX upgrades are done.
  358.  
  359.        Note that the _p_c_p__e_o_e subsystem is part of IRIX and is on
  360.        the Foundation-2 CD of the base 6.5 distribution and the
  361.        third CD of the 6.5.8 (or later) overlay distribution.  The
  362.        _p_c_p subsystems for IRIX 6.5 are on the PCP 2.1 CD.
  363.        Concurrent installations are best performed using the ooooppppeeeennnn
  364.        command to select products from multiple CDs.  For further
  365.        details, refer to the _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d
  366.        _L_i_c_e_n_s_i_n_g _G_u_i_d_e.
  367.  
  368.        2.7  _P_o_s_t_-_I_n_s_t_a_l_l_a_t_i_o_n__P_r_o_c_e_d_u_r_e_s
  369.  
  370.        If the Performance Metrics Collector Daemon (PMCD) is to be
  371.        started (i.e. this system is to be a PCP collector) use the
  372.        following commands as rrrrooooooootttt:
  373.  
  374.            # chkconfig pmcd on
  375.            # /etc/init.d/pcp start
  376.  
  377.        Refer to the ppppmmmmccccdddd(1) man page for more details.
  378.  
  379.        For IRIX 6.5, the cccchhhhkkkkccccoooonnnnffffiiiigggg option for ppppmmmmccccdddd defaults to
  380.        ``on'', otherwise it defaults to ``off''.
  381.  
  382.        A ppppmmmmiiiieeee(1) process can be run as a daemon as part of the
  383.        system startup sequence, and can thus be used to perform
  384.        automated, live performance monitoring of a running system.
  385.        To do this, run these commands as rrrrooooooootttt:
  386.  
  387.            # chkconfig pmie on
  388.            # /etc/init.d/pmie start
  389.  
  390.        By default, these enable a single ppppmmmmiiiieeee process monitoring
  391.        the local host, with the default set of ppppmmmmiiiieeeeccccoooonnnnffff(1) rules
  392.        enabled.  Refer to ppppmmmmiiiieeeeccccoooonnnnffff(1) for more details.
  393.  
  394.        2.8  _C_o_m_p_a_t_i_b_i_l_i_t_y
  395.  
  396.  
  397.  
  398.        As noted above, PCP 2.1 will not work with any IRIX 6.5
  399.        release prior to 6.5.5.
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                                   - 6 -
  413.  
  414.  
  415.  
  416.        PCP 2.1 involves evolutionary changes that may affect some
  417.        PCP upgrades and PCP add-on products and/or applications
  418.        developed using the PCP libraries.  Refer to section 3 of
  419.        these release notes and the _p_c_p release notes for a complete
  420.        discussion of these issues.
  421.  
  422.        2.9  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  423.  
  424.        It is expected that no configuration changes will be
  425.        required for the _p_c_p__e_o_e product, however if the _p_c_p product
  426.        is also installed, then a variety of site-specific
  427.        customizations may be involved.  Refer to the _p_c_p release
  428.        notes for more details.
  429.  
  430.        2.10  _F_i_l_e_s__N_o_t__L_i_s_t_e_d__b_y_vvvveeeerrrrssssiiiioooonnnnssss
  431.  
  432.           +o /_v_a_r/_a_d_m/_p_c_p_l_o_g - the diagnostic logs from ppppmmmmccccdddd and
  433.             PMDAs for a PCP collector configuration reside here.
  434.        If the _p_c_p product is also installed, then additional files
  435.        may be present.  Refer to the _p_c_p release notes for more
  436.        details.
  437.  
  438.        2.11  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  439.  
  440.        After installation has completed you should run the command
  441.  
  442.            showfiles -c -C -H pcp_eoe
  443.  
  444.        This will list files that have been customized for your site
  445.        and that were changed at the most recent _p_c_p__e_o_e
  446.        installation.  Existing files moved aside will have a ....OOOO
  447.        extension and new files that were not installed will have a
  448.        ....NNNN extension.  You must reconcile any differences between
  449.        the files by hand.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.